/**
 * 文  件  名：  IBlogCommentDao.java
 * 工  程  名：  7You
 * 创建日期：  2013-10-13
 * 创建作者：  杨  强
 */
package com.qiyou.dao;

import java.sql.SQLException;
import java.util.List;

import com.qiyou.entity.BlogComment;

/**
 * 博客评论信息数据操作接口
 * 
 * @author 杨 强
 * 
 */
public interface IBlogCommentDao {
    /**
     * 添加评论信息
     * 
     * @param blogComment
     *            评论信息
     * @return true成功，false失败
     * @throws SQLException
     *             数据库异常
     */
    public boolean doCreate(BlogComment blogComment) throws SQLException;

    /**
     * 更新评论信息
     * 
     * @param blogComment
     *            评论信息
     * @return true成功，false失败
     * @throws SQLException
     *             数据库异常
     */
    public boolean doUpdate(BlogComment blogComment) throws SQLException;

    /**
     * 删除评论信息
     * 
     * @param blogCommentID
     *            评论信息ID
     * @return true成功，false失败
     * @throws SQLException
     *             数据库异常
     */
    public boolean doDelete(long blogCommentID) throws SQLException;

    /**
     * 获取评论信息
     * 
     * @param blogCommentID
     *            评论信息ID
     * @return 评论信息
     * @throws SQLException
     *             数据库异常
     */
    public BlogComment getBlogComment(long blogCommentID) throws SQLException;

    /**
     * 获取指定用户的评论信息
     * 
     * @param userID
     *            用户ID
     * @return 评论信息集合
     * @throws SQLException
     *             数据库异常
     */
    public List<BlogComment> getBlogComments(String userID) throws SQLException;

    /**
     * 获取指定博客的评论信息
     * 
     * @param blogID
     *            博客ID
     * @return 评论信息集合
     * @throws SQLException
     *             数据库异常
     */
    public List<BlogComment> getBlogComments(long blogID) throws SQLException;

    /**
     * 获取指定条件的评论信息集合
     * 
     * @param params
     *            查询条件，可为空
     *            <p>
     *            示例：
     *            <ol>
     *            <li>new String[]{"where `motherID` = 0"}<br>
     *            将查询上级评论ID为0的评论信息集合</li>
     *            </ol>
     *            </p>
     * @return 评论信息集合
     * @throws SQLException
     *             数据库异常
     */
    public List<BlogComment> getBlogComments(Object... params)
            throws SQLException;
}
